Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

SetMoviePreviewMode

The SetMoviePreviewMode function allows your application to place a movie into and out of preview mode. When a movie is in preview mode, only those tracks identified as preview tracks are serviced. You specify how a track is used by calling the SetTrackUsage function, which is described on page 2-102.

pascal void SetMoviePreviewMode (Movie theMovie, 
                                 Boolean usePreview);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

usePreview

Specifies the movie's mode. Set this parameter to true to place the movie into preview mode. Set this parameter to false to place the movie into normal playback mode.

DESCRIPTION

When you place a movie into preview mode, the Movie Toolbox sets the active movie segment to be the preview segment of the movie. When you take a movie out of preview mode and place it back in normal playback mode, the toolbox sets the active movie segment to be the entire movie. For information about working with active movie segments, see "Enhancing Movie Playback Performance" beginning on page 2-119.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid